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Introduction 

This nemo describes the Interface between user programs and 
the PDP-1 timesharing supervisor* Sections identified with an 
asterisk ($) may be omitted on a first reading. 

Needless to say, this memo is subject to change without much 
notice o Spheres and entries are especially likely to undergo 
development * 

The following convention is used to specify the location of 
information in registerst 

'" ' u i i J i 4 \> * 6 7 a' y io iria 13 iAs ib if * 

a« ^SLlJ^y 1 ^ "J 811 bi ?f ht \ 17 is the " least significant 11 bit. 
An expression such as A(n-m) refers to the contents of bits n 

^f^ ?u° f 4 resl i ter *** or example, l(9«*17) refers to the right 
half of the lit-out register* 

/ ^^L™* 111 * 3 ™ 180 * calls •*• bridled by meta-instructions 
i?^ 7 !^? ^ J^ ?*** 1011 « what acti °n to takers contained in 
?"f J-41 and 15-47 of the instruction itself, as well as m the 
live registers* 

n^So^c 10 ? *£ the i?****** 6 registers A, i> x, F, and Q, each 
ll^LL ^%h* J- **f ister * ***** is maintained' entirely in 
software by the supervisor. Certain operations require or supply 

££n?^ 0n to „ the W plater* To facilitate the witl^of 
reentrant procedures, supervisor calls never make use of X* 

Instruction Action 

mta o copy A into W. 

rata 1 copy I into W* 

mta Z Copy W into A* 

mta 3 copy w into I* 

*u S i nce *£**? instructions are interpreted by the supervisor* 
they are much slower than similar hardware instructions such as 
liao 

« JB* Instructions »ta 4, mta 5, mta 6, and mta 7 are special 
iMtructions Which trap to the program's superior (usually id). 

^Jiifefc^f 1*11 f 8 *"•* *«> ■*» Htt normal completlra to ». 
memo BDpSI) request to perform a oomnana string (see 



Gore Memory 

Each program has an address space consisting of those cor© 
Tf^JfSS® 8 ! 8 ? u ** P®™*****' to reference e The address space 
^»?H« d ^ J*? ]P lts of iooo ° Coctai) words* called "Sore 
modules" or simply "cores". The address space consists of "real« 

JET!^*?"* 8 * 8 * T™ ° J* to (at "^J 5* and attachments (see 
i^LSS ct i^J Jft 8p 5K*? for . a discussion of attachments)* The 
t£2& l 11 ^. 18 thQ l0 *® st address not in a real core. Upon 
logging Xn, fhe misovy bound is iOOOO and there are no attach- 



ments* 

rata 206 



Read memory hound and attachments to A, 

attaehisents 
bound| 10 1 2 3^51 




mta 207 



fit kT^^JFS! 1 : . The nuB *» of «ores is specified in 
£Hr5J °El J f fcha 5 *? SBero * A Cl5~17)* The memory bound 
cannot be lowered to zero or raised above 60000* The 

h^^^J^ 13 ^ 80 * 8B is not censed. If the memory 
?^f^ ^.J 8 J* 18 *** a *F attachments that are in the my are 
automatically removed. The instruction skips if success- 
ful o if unsuccessful , the asmory bound and all attach- 
ments are unchanged* 

mta 205 

Detach* The core number is taken from A(3~5) or, if that 



«** ^J?^*? to reference addresses outside of the address space 

are illegal* and normally trap to the Drojcramfia -jwr»TH^7m 
prints « and the offending instruction)! pAOfiram s "«P«i« (» 

program nsay 



4^T~T! ~ w *** v * A * w^neierreo to tne aaaress specified by the 
Si2S 25 n K? r f?^^2 c f wtonu W(3«i?) will eontata the o?ogram 
£25$X ?* the tlB » °* the Illegal iseiaory reference. w(o-l) fill 

5S?« ? ^ PH 18 * **«***?*« «w unchanged, If Ml (see part 2 of 
SS^^ t iffi , ? Mll) m t Gn *» «• lUegai^Sry reference 
t£^n!&u2 J! 111 5f , on * The Illegal memory- reference return may 
SsbJS! y S ^ " t0 a W tlw ««&>«• .» is inmany 

mta 202 

Read illegal memory reference return to A 
mta 203 

Set illegal nmmory reference return from A 



Illegal Instructions 

Certain instructions are illegal <> Honn&lly these trap to the 
program 8 s superior (ID printF^yaBl the offending Instruct ion)» 



A program may intercept some of these traps (recoverable 
Illegal instructions) by setting its Illegal instruction returnT 
The following instructions ere unrecovlraS^^iHe^l t hitT^Spfs 
opcode 00 # priviledged instructions* and attexapts to reference 
locations through 77 when PRL is on {see below) * All other 
illegal instructions are recoverable When a recover&bly Illegal 
instruction is executed, control is transferred to the address 
specified by the illegal instruction return* tf(3«&7) will contain 
the program counter at the tin of the illegal instruction (i e * 
the address of the instruction)* W(0-£) are clearedo The original 
contents of W are lost* Other registers^ including AAx^ are 
unchanged* The Illegal instruction return may be disabled by 
setting it to a negative number* It is initially disabled* 

rata 800 

Read illegal instruction return to A* 

rata 201 

Set illegal instruction return from A« . 

(#) Low Priority Mode 

A process may enter low priority mode by executing a mta 100* 
Thereafter, the process wiIt~run^oHly"" if no other processes 
(except other low priority mode- processes ) want to run 



Capabilities , 

System resources, such as tape (drives, drum fields, and 
typewriters, are raade available to the user through capabilities* 
A user is permitted to use a resource if he owns a HSSnfKTTo 
the resource* Each capability is distinguished by an index from 
to 77» The index of a capability is specified when the capability 
is created (though it oay be changed later by mta 4oi), and no 
two capabilities tsay have the sairte index* The capabilities are 
stored in an area of memory known as the enlist « 

Upon logging in, the user has only one capability, to his 
console typewriter, at index zero* Also, only indices from to 
17'BBy oe useds to increase the available x&xmi to 77* see the 
description of rata 403 below* 

* *. To ^|fly?¥f a £»P»tt4ty which he c*mss a user executes an ivk 
!? str ^ ion (^ v ^T^000O). Bits ifi-dLT of the ivk instruction Si 
the index of the capability being invoked (e*g«, ivk 14 operates 
the^resouree at capability index 14 )« Bits- 8*41 of the ivk 
instruction are called the variant, and, along with A* i, and w. 
my specify what operation iBTo - "Bwce place * The effect 'of the 
instruction differs for each type of capability, m® 
reminder of this mmo describes the types of capabilities which 
nmy be created and how they are used© 

-capabilities are created with instructions of the form nta 
3 n ^?«IL n $ ^ a For aU s ¥ ch instructions, the index of the 
capability Ts specified hy A(12~l7h if this is zero, the first 
free index is used* The index is returned in A(12«47) with A?0- 
%1 K 2,^° Th ® x register and A(G~il} may contain parameters 
pertaining to the capability to be created* The capability 
created refers to a new object, not owned by anyone else*, (From 
the point ©f view of ■ the super-visor, objects are u allocated 8 <? ' 
from the point of view of the user, objects are u created" . ) if 
SS^w^* th f i«s^«ctian skipso A copy of the capability (what 
mta^ MX>(q.y.j reads) is returned in I. if unsuccessful, the 
instruction does not skipo Either the requested index (or, if 
was requested, every index) was already ©ccuoied, in which case 
toe capability at that . Index . (or, . if . o was requested,, the last 
indexj is returned in I, or else the index wae available but 
there were insufficient resources (e Q g drum fields) to create 
**he object, in which case 1 is cleared 

The following instructions ns&nlpulate capabilities 5 
mta 204 

Delete- capability. A (12.-17) contains the capability 
index* if there is no capability at the specified index* 
no action is taken* A aM 1 are unchanged,, 

snta 4oo 

Read capability. A (12-47) contains the capability index* 
An 13-bit word uniquely specifying the capability is 

placed in A. if no capability exists at the smsclfied 
index, A is cleared « 



mta 401 



mfee 402 



rata 403 



Exchange capabilities* The capabilities at the indices in 
A(6-41) and A (12-47) are exchanged* Null capabilities way 
take part In the exchange • 

Turn off pRLo Undoes the effect of rata 403 (a 9 v*)* 
Capabilities at indices 20 through 77 are deleted* * (For 
spheres not at the top level, capabilities at indices 
through 17 are also deleted* See the section on spheres 
for details* ) 

Turn on PRL (program reference list). When PEL is on, 
capability indices through 77 siay be used* The c-liet 
is stored in locations through 77 of the programs 
address space* To protect against unauthorized modifica- 
tion of this Information* the program is not permitted to 
examine or modify these locations* The state of FHL is 
read by bit 8 of the cks word (see part 3 of this 
Instruction Manual L 



lata 404 
sntea 405 



Count capabilities* Return number In A* 

Copy capability* The capability at the index in x(6-4l) 
is copied into the index in X(12-17) (or the first free 
index if x(12-47) is sero)* The index is returned in A* 
The instruction skips if successful* and a cony of the 
capability is placed in X* if unsuccessful, the instruc- 
tion does not skip* Either a capability already exists at 
the index in X (12-4.7) (or at all indices if J (18-47) is 
£ero)* in which case that capability (or the last 
capability) is placed in l s or else no capability exists 
at the index in X(6-il) or the capability there is an 
entered process capability* in which ease X is cleared* 



(*) 



Disown capability » The capability at the index in 1(6-11) 
is deleted without deleting the corresponding object* 
CFor exaople* if a sphere capability is disowned, the 
sphere continues to run# occupy storage* own other 
capabilities., etc*) An index is returned in A (12*47) with 
A (0«4l) cleart this index is to be used to reclaim the 
capability ((see mta 502)* It successful, the instruction 
sidp3 5 and a copy of the capability is placed in X* 

mta 50S 

Claim capability* The disowned capability whose Index is 
in X(6«liJ is placed in the index in x(12«47) (or the 
first free index if x(i2~iy) is sero)* The index is 
returned in A* If successful* the instruction sklosu and 
a copy of the capability is placed in X* If unsuccessful. 
the sata© action is tataen as for rata 4o$* 



Typewriter 

A program is normally given a typewriter capability at index 
ssero by its superior A typewriter may be created* however* if it 
is not logged in or otherwise owned « Mta 306 with 05 in A (6=5) 
creates a typewriter capability A(6«4l) has the desired console 
number* A (12-47) has the capability lndez 9 The instruction skips 
if successful* 

For typewriter ivks^ if the variant is zero* A(8«lo)+l is 
used to specify the operation* 

Variant Operation 

Type out from Ao The flexo code character in A(12«47) is 
typed outo 

2 

Type in to A* The character typed is placed in A(42«47) 
with A(0»ll) clear 



3 
4 



Type out from Xo The flexo code character in l(l2«47) is 
typed outo 

Type in to l« The character typed is placed in 1(12-47) 
with x(0*4£) clear 



It is occasionally desirable to share a typewriter with 
another program* but in such a way that the original owner may 
assert control over the typewriter when it wishes* without 

finding and deleting all copies in the recipient,, (For e^amole^ 
W wants to share its typewriter with the user under ito) An 
inferior typewriter capability is a typewriter capability with an 
enable/disable switch© When the typewriter capability is dis*= 
abled* all ivks on it will hang until the capability is enabled* 
The recipient of an inferior typewriter capability is not aware 
of the enabling and disabling* Inferior typewriter capabilities 
?my be created to any reasonable depths and each has its own 
enable/disable switch * 

Variant Operation 

5 Enable o 

6 Disable o 

7 Unused o 
10 Unused* 



11 



Turn off enable/disable permit for the lvk fl ed capabllityo 

Enable/disable permit is a property of each copy ©f the 



12 



e=» 



capability., not of the inferior typewriter as a whole « 
This is used to prevent the recipient of an inferior 
typewriter capability from interfering with the enab 
ling/disabling activities of the superior* 



Create inferior typewriter* The ivk®ed capability is 
replaced by an inferior typewriter capability. Skip if 
successful. The next capability will be disabled^ with 
enable/disable permit on? 



paper Tape Readier 

The PDP»i has a photoelectric paper tape reader capable of 
reading 320 or 640 lines per second, as selected by a toggle 
switch on the left side of the reader rack* Eight-hole tape is 
normally used* although five, six. and seven hole tape may also 
be read. Mta 306 with 03 in A(0~5) creates a reader capability* 
A(i2~i7) has the capability index* A (11) specifies how ivks on 
the reader will be treateds for alpha mode^ 1 for binary mode. 
The rata 306 skips if successful* For reader ivks, the variant and 
A are ignored. 

Alpha mode #*«%»* 

One line of tape is read and placed in A(10-17/» A l - 
represents a hole* a o represents no hoi* • Channel 8 (the 
channel farthest from the feedholes) goes into bit 10, 
channel 7 into bit 11, etc, A (0-9) «** cleared. If 
successful, the ivk skips . If the reader -2s out of tape, 
the ivk does not skip* 

Binary i&ode 

Three lines of tape are read* Channel 8 must be punched j 
if not, the line is ignored. Channel 7 is always ignored. 
Channels six through one of the first line are placed in 
• A(0-5)# A(6-li) is filled from the second line* trad A(12- 
17) from the third. If successful, the ivk skips. If the 
reader is out of tape, the ivk does not skip* 



Paper Tape Punch 

The PDP-1 paper taoe punch punches standard eight^hole tape 
at a speed of 63 lines per second. Mfca 306 with 04 In A(0-5)- 
ereates a punch capability,, A(12«17) has the capability index. 
The inta 306 skips if successful. 



A punch ivk causes one line of tape to be punched. Tape 
channels eight through one come from A(10«1?) respectively. The 
feedhole is always punched. 



Button Consols 

The consoles of buttons and switches are described In part '3 
of this Instruction manual . Mta 306, with 01 In A(G«5)* creates a 
button console* A(lCMLl) has the console nuraber* A(l£-17) has the 
capability index* The mta 306 skips If successful* 

Invoking a button console capability hangs until the state of 
the buttons Is different from the contents of A* The new state of 
the buttons Is placed In A (in the same forest as rbt) and the 
Instruction completes* Rbt Instructions work Independently of 
button console capabilities* 

Temporary Clock 

Mta 306 with Qg in A (0-5) creates a clock capability* A(12« 
17) has the capability index* The mta 306 skips if successful! it 
falls only if the capability index was already occupied* 

The temporary clock ticks 1760 times per minute (about 30 
ticks p®v second] a A clock ivk hangs for °4 contents of A) ticks* 
A Is incremented at each tick* ai^d the Instruction completes when 
A is positive or zero* 



Microfcapes 

The FDP«1 has four mierofcape (Dectape) transports « A standard 
reel of tape has 1000 (octal) blocks of 400 (octal) words each* 
There are a number of n public" mierotapes providing convenient 
storage for users* 

Ifeebanicai operation of the tape drives 

The following state diagram shows how the drives are eon= 
trolled* 



run 




auto 



Wh&n a drive is off^ the motors are not operating* and a tape 
m& be mounted or removed* When in is&nuai mode 3 the motors are 
under control of the n fwd H and "rev" buttons* When in automatic 
or write permit fsodes, the motors are under control of the 
computer and the tape ts&y be read or ^fritten under program 
control*. 

To mount a tape, press it firmly onto the left hub^ draw the 
tape over the head and onto the empty reel on the right hub* and 
wind it onto that reel one or two turns by hand« press the "run* 
button to place the tape in n&nual status 9 and run the 
forward for a few socot&s* Tb®n lift the q auto n button* 
\^ the tt write a button if desired* 



"run 8 



To reiaove a tape^ press the "stop® button* followed by the 
atton* Move the tape in reverse by means of the "rev* 1 
button until.it cosaes completely off the take-up reel* Press 
!l st©p% stop the coasting tape by hand, and remove it* 

Use of Microtapes 

Normally ^ roierotapes are used through the Mierotape Pile 
System (see memo FBP«*te) e All tape instructions operate directly 
on microtapess without reference to any file structure*, Mta 306 * 



with 00 In A{0~5)* creates a mlcrotape capability,, A (8*41 ) has 
the desired transport number (0~3)o A (12-17) has the capability 
index* It skips if successful 

On a microtape ivk, the variant is Ignored* A(CML) is decoded 
as follows 

00 - read 

10 « write 

01 « rewind* The instruct ion completes when the rewind is done, 

11 -■ rewind* The instruction completes immediately 9 Any subse« 
quent tape instruction will override the rewind* 





2 ffi 00 * coun | l b . J bl QCk number _j l 

^ if sere i Qtfe kfock t's- °f*XHiPcrrtf/ - 

For read and write operations* X(0-£) contains the mmh&v of 
blocks to he transferred^ •' 1(9-47) contains the block number ©f 
£he tirst tolock to be transferred,, Consecutive blocks are 
transferred to consecutive areas in core* Block is considered 
to follow block 777 „ The core address of the first word of the 
first block is given by M3~&7)g it must be a multiple of 4o 
words o No block may .toe transferred partly into one core and 
1 SS J Sr r 1} 2 t0 •ft ** 1 *** but different blocks may be transferred t© 
different cores in the game operation* 

^ J f , A i?)"?* th ® felTOk number In 1(9-17) is translated into a 
physical block number This is the normal case., as it allows 
consecutive block numbers to be read in one pass across the tape Q 
Block numbers 0, 1, ooa , 377* 400* Jioi, 000 , 777 translate 



physical blocks i # 3, ..•, 777* 776, 77*# —i o If A(2k, the 
physical block number in XC8~17) is used without translation* 
This allows tapes with more than 1000 blocks to be reado 

If an blocks are transferred successfully, the instruction 
fjS ps * living the address of the last word transferred^! in A?3- 
171 with A|0-g) unchanged* the number of the last block 
transferred^! in 1(9-47), &Rd sero in X(0-5). If an error occurs 
on any bloek f the instruction does not skip* 2(9-17) contains the 
number of the block in which the error occurred., and X(0-5j 
contains the number of blocks remaining* including the one that 
was in error* Furthermore^ an error code is placed in Ag 

<■» tape unit is not in automatic status 

1 -> block cannot be fousrsd (probably bad tape) 
£ •» illegal core address 

3 - checksum error (the data transfer took place anyway) 

4 - mark track error (probably toad tape) 

I - data channel error (serious hardware malfunction) 
o • no write permit 

For rewind operations* the instruction skips unless the tape 

unit is not in automatic status* in which case A is cleared* 



Drum Field 

A drum field Is a 10000 (octal) word block of medium-speed 
memory. Transfers take placa between the drum and ©ore memory. 
The Initial drum address and count (number of words transferred) 
must be multiples of 4o (octal) words- A drum field, like the 
drum, is circulars if a transfer extends past the end of the 
field, it will "wrap around" to the beginning of the same field, 
A transfer raay not cross a core boundary* The core address need 
not be a multiple of 40 words. If the count is zero, 10000 words 
will be transf erred, 

Mta 300 creates a drum field. The capability index is 
specified by A(12-1T)* If A(o) is 1, the absolute field number in 
A(5-ll) is used, and writing on that field will be illegal (any 
absolute field may be created in this "read-only 18 mode)* The mta 
300 skips if successful* 

The core address for the transfer is specified by W(3-&7{* 
the drum address/4o hy l(6~12), and the word ccunt/4o by A(6«12J* 
Note that the drum address and word count appear in the Inormal" 

position in the word* A (13) is to read from the drum* 1 to 
write. The' drum ivk skips if no drum error occurred Q 

A 1 I count 




Mta 104 and -mta 105 are used to read any absolute drum 
address «, The format is the same as for a drum Ivk, except that 
the drum field comes from x{0-5). Mta 104 reads fields Q=>77j mta 
105 reads fields 100*477* Mta ^°4 and mta 105 skip if no drum 
error occurs o 

Progransned Queue 

Queues are described in Fart 4 of this Instruction Manual 



(£) Hardware l/o 

The design of the PDP-1 allows certain l/o operations to be 
performed directly by users « An extensive and somewhat accurate 
description of this facility may be found in memo PDP~33» 
Input/Output in the PDP~1~X PRL must he on to operate hardware 
directly Tse© description of mta 403) • 

Mta 306, with 07 in A(0-5) # creates a hardware l/o capabil- 
ity. A16-II) has the I/O device number « A (12-17) has ^ he 
capability index. The mta 306 skips if successful a 

The following device numbers are currently used? 

1 - new drum A 

2 - new drum B 

16 - teletype input 

17 - teletype output 

20 - microtape unit monitor 

21 - microtape data control 

22 - speech controller 

23 - ditto 

24 - ditto 

77 - microtape motion control 

Some of these devices are described in separate memos 9 Most 
require special turn«on procedures Devices 20 9 21, and 77 cannot 
be assigned! microtapes are referenced by other means* 



Sphere 



One of the inqportant concepts in timesharing is that of 
extensibility, A timesharing system is extensible if it is 
possible, from a console, to construct another timesharing system 
underneath the first. It should be possible to change the 
characteristics of the systems for example* on© might vmnb to 
cause what would nom»lly be typewriter output to become spoken 
speech. Extensibility goes a long way toward making a timesharing 
system both useful and general. The PDP-i timesharing system is 
extensible. The objects which nsake this possible are spheres and 
entries. 

Everything which has been said about tt programs H in reality 
applies to spheres. The user gets a sphere when he logs in. Each 
sphere has its own address space, processes i*hlch run in that 
address space, and capabilities which those processes may invoke. 

The initial user sphere nay have capabilities through 1? 
even t*hen PRL is off, other spheres may not % they must have PRL 
on to have any capabilities, 

Mta 302 creates a sphere, A(12-&7) kas the capability index, 
1(3-17) l»s the fault entry address {see below). The mta 302 



skips if successful, "TrSe'™ sphere Tn which the mta 302 is executed 
becosses the superior of the sphere which is created. The initial 
state of the sphere isj 



meiaory bound 


10000 


attachments 


none 


PRL 


off 


processes 


none 


process hoard 





run indicator 


off 


breakpoint 


-0.0,0 

(disabled) 


variables 


illegal instruction 


-0 (disabled 


return 




Illegal nsemory 


-0 (disabled 


reference return 





There are two kinds of sphere capabilities, ^ster and npfl~ 
master., Mta 302 creates a roaster sphere capability. There is at 
most one copy of a siaster sphere capability, owned by the 
sphere 8 s superior- Whenever a naster sphere capability is granted 
or shared (hy mta 405 or an appropriate sphere ivk), the new copy 
is a non-saster sphere capability. When a master sphere capabil- 
ity is deleted (either explicitly or hy granting it), the sphere 
no longer has a superior. The sphere itself is deleted only when 
all capabilities referring to it, naster and non~&aster, are 
deleted, Mta 501 and mta 502 are considered grants. 

Core ssodules that are not assigned as ®real B cores nmy be 
cade into attachments. An attachment is a core module that is 
shared aioong several spheres,^ it ~Ts a"*real* core module in one 



of the spheres and an attachment in each of the others* Memory 
references to an attachment are directed (efficiently) to the 
attached "real* core module* Cores which are attachments need not 
he consecutively numbered* An attachment will disappear without 
warning if the attached core is deleted* The core of a sphere 
with PRL on cannot* unfortunately, he attached! the read/write 
sphere ivk must b© used to reference such a core* 

Each sphere has an enable or run indicator* processes in the 
sphere nay run only if the indicator is on* When the indicator is 
off* no processes nay run or be created by an enter * When the run 
indicator is turned off, processes that are in M soft" waits (all 
waits except enter, queue, and hardware x/o waits) will be 
removed from the wait* They will re-execute the instruction when 
the run indicator is turned back on* Processes that are in enter, 
queue, or hardware 2/0 waits may have the wait complete, but they 
will not resume running* Certain operations on spheres, such as 
manipulation of processes, nay be done only when the run 
indicator is off* 

Certain instructions, including all unrecoverably illegal 
instructions, are treated as enters into the superior sphere* 
(See the section on enters*) Recoverable illegal instructions and 
Illegal memory references are treated as enters if they are not 
handled by the illegal instruction or illegal memory reference 
returns* If the sphere has no superior, the instruction waits 
until the sphere gets a superior (possibly forever)* 

When a superior enter happens, the entered process starts 

executing at the fault entry address* Its A register has the 

index of an entered process capability e Its l register has the 
reason for the trap© 

- illegal instruction 
■ ■ 1 - lock fault 

2 - ESI trap 

3 ~ I/O function busy trap (hardware devices only) 

4 .« bpt trap 

5 - hit 

6 - Illegal memory reference* return not enabled* 

7 - unused 
10 - mta h 



12 « mta 6 

- mta 7 (dsmi 



If the entering process is "restarted 11 , it will enter again 
(immediately, unless its run indicator is off) without re« 
executing amy instructions, unless its registers have *b®®n 
written on with a sphere ivk* 

Thei?® are three " breakpoint w registers associated with each 
sphere hat enable the execution of instructions to be counted at 
(reasonably) high speed* The registers will herein be called bpl, 



bpg, and bp3. Bit 6 of the P register is called ESI (execute 
single instruction). Whenever it is on, a special ESI trap occurs 
to the supervisor at the end of each instruction (including 
supervisor calls, enters* etc,} executed by the process. In 
addition, the bpt instruction | "breakpoint*, 77004*0 causes a 
special bpt trap. The breakpoint mechanism can be disabled by 
setting bpi to ~0„ 

{M} Whenever bpt or ESI traps occur from any process (no 
checking is done to see that it is the same process each time) 
the following action is taken. Bpl(o) will be called A* 
will fee called B. 



"Meaning" of A and B2 

AB • 00 t not a superproceed 

10 : superproceed, haven 8 t hit bpt yet 
01 t hit bpt, proceeding under ESI 
H l proceeded, further bpts Illegal 



(bpt trap ) 




cause 

trap 2 




save the instr at 
;he address in bplj 
n bp3, replace 
t with bpt 



j cause 
1 tra p 



resort 
process 




trap 2 



restart proces 



Sphere ivks 

If A(l4)*»0, the operation Is a read/write core* A (13) .is to 
read the invoked sphere 9 © memory # 1 to write. Either of the core 
modules taking part in the transfer may be an attachment, The 
word count and sphere address must "be multiples of 4o # The 
transfer may not cross a core boundary in either sphere „ if pel 
is on in either sphere, locations through ft of that sohere may 
not be read or written on. The word count/4o is. in A(6~%k)f if it 
is zero, 10000 words will be transferred. The address in the 
invoked sphere is in 1(3-4.7 )# &nd the address in the invoking 
sphere is in W (3*4.7)© The instruction skips if successful. 

A 1 i count jR/WI Qt 



X 1 I spher e address 1 

"T"' —j nn^mnr—n-rrr-F * iniii 111111 1 11 1 11 1111 11111 1 rn ■ 1 1 |ii i iJi m.i|i nw « 1 111 1 X".-! 1 ' 



W I • I core address 

Other sphere ivkss 

code in A Operation 

Suppress processing* The run is^&icator is turned off, 

3S. 

Permit processing* The run indicator is turned on. 

Attach*, The core module of the invoked sphere (the 
attachee) specified hy X (15-47) becomes attached to the 
sphere executing the ivk as the core mcdule specified by 
X(3~5)o This instruction will succeed if the attached 
core eKlsts (as an attachment or a real core) and the 
attaching core is not a real care, if the attached core 
is itself an attachment , its attachee will be used, if 
the attaching core is a previous attachment 9 it will be 
- removed « An attachment may be inade and maintained whether 
the run indicator is on or off. Skip if successful o 

Reverse attach* Similar to attach* The core module of 
the invoking sphere specified by 1(15-4.7) becomes at- 
tached to the invoked sphere as the core module specified 
ts^r X|3~5l» Skip if successful* 






132 



152 



412 



432 



Read process state e The x^egisters of the process whose 
number is in I are read and stored in six consecutive 
words, beginning at the address in w(3~i?)« The order is 
A* G# X# X* F* and W* Processing must be suppressed* 
Processes are numbered beginning with i* This instruction 
will fail if the numbered process does not exist or the 
run indicator is on. Skip if successful * 

Write process state* Similar to read process state. This 
will fall if the numbered process does not exist, the run 
indicator is on* or the process is in a wait* Skip if 
successful* 



Read breakpoint state* The three words of breakpoint 
state are read into three consecutive words beginning at 
the address in X(3«i7)« 

Write breakpoint state* Similar to read breakpoint state* 

Create process* A new process is created for the sphere $ 
and becocms the highest nus$>ered process* The process 
number is returned in A, The mm indicator must be off* 
The instruction fails if no process is available* Skip if 
successful 



-* 



Delete process The process whose number is in X is 
deleted* All higher numbered processes are renumbered* xf 
the process is in a wait it will be deleted anyway but 
the process hoard will diminish by i* This instruction 
fails if the nui^ered process does not exist or the run 
Indicator is on B Skip if successful * 

Count processes o The number of processes in the sphere is 
returned in A* 



Subjugate* The sphere in which the ivk was executed 
becomes the superior of the invoked sphere* The X 
register contains the new fault entry address* The 
invoked capability becomes a master sphere capability * 
Any processes waiting to enter will enter immediately 
unless the run indicator is off* This instruction fails 
if the sphere already has a superior <, Skip if successful* 



6212 



632 



Execute mta.* The w register is moved to A* ar*d tho 

executed as if by a process in the snhepe vsi-),,~« 
returned by the meta-i„struction win be pSd in A and 
is iffi«i? B t^ 10ns ^ «!*a 200 nay be executed. The £8 

executing the instruction. li8fc ° f the spher@ 



?SSl*.-4.^ ea ? ablll ? y to the sphere executing the 

ysrs&s as.* - the «w *** ■,*& ««« 

658 Reverse grant. 

arant. Grant and reverse grant are similar to .ha» E „ rf 
SEES Bhare » except fchat *** «*Sr?rSj Is ctSted^ 
bfsSrelfr 83 CapabillWes ™y ^ granfT&y^y'not 

Format of (reverse) share artf grant 
X 5 Pit ?5 tno c=,lis * of the receiver at the index in 

If fucIissLr^rf^r *?+?**** free **** ottemsS 

ScSr ii^kcel If t \% *»* «P«»tUtar created in the 

t w A ;^ i3 pxscea m A am a copy of the caoabiiifev in 

leceivlrXr^ 8 ??^' J 1 ther «»«««•*«» &5S 2 tte 

««*e'CMuy wQupi,ea # j.n which case the caDEbiiifcv a* *h«* 

no MfflSuJt? for in ?n X ^« th ^ »«*v.r was available^ 
*«<y» ^<*p»©aj.3.^y |or^ in the case of (reverse) qkn^ fsv* 

ffi - ? K 00 ; 88 «*■*""*) existed a| iL Sried 



($) Entry 

An ISSSL is a user^rogrammed capability, The action which 
occurs when an entry capability is invoked ia entirely under the 
control of a program. For exaiaplej an entry can be used to 
simulate any of the other kinds of capabilities . 

There are two kinds of entry capabilities, master and non~ 
gagtgr* Invoking a master entry capability pevfaSmTapevat^iS 
relating to the entry itself* invoking a non-asaster entry 
capability sets in motion the entry mechanism to be described 
below. 

For each entry there is at all tiises exactly one copy of a 
master entry capability., owned by the sphere which created the 
entry. Whenever a master entry capability is granted or shared 
(by rata 405 or an appropriate sphere ivk)* the new copy is a non~ 
master entry capability,, When a master entry capability is 
deleted (either explicitly or by granting it), the entry becomes 
unuseabie? invoking non~*naster entry capabilities corresponding 
to the same entry will be illegal* 

JSAeh copy of an entry capability has a 6«bit transmitted 
word* when an entry capability is granted or sKaxST"TEe 
transmitted word is copied. The transmitted word of a master 
entry capability may be changed hy invoking the capability with 
the desired transmitted word in A (12-47) and A (0-41 ) clear* The 
transmitted word of a non«master entry capability cannot be 
changed* The transmitted word is a tool* for distinguishing 
several stellar entry capabilities without creating a separate 
entry object for each one* 

* ,*.?*?, ^07 w® 8 * 6 * s master entry* The transmitted word is 
initially zero* The I register contains the entry address 
(explained below).* A (12-47) contains the capabiliw^Siefr^^f^ 

mta 307. skips if successful* 

When a non«master entry capability is invoked, a process is 
created in the sphere which created the entry (the enteree), it 
starts executing at the entry address which was specIHeef when 
the entry was creat8d* its A is initialised to the index of an 
g3£§*2* KBS8I& SBSfiSliSE w*4<* i» created when the entry is 
invoked iss Xu^^yj contains the- transmitted word of the 
invoked capability . its I (8=41) contains the variant of the ivk 9 

A process trying to enter will wait until all ©f the 
roll wing are true* i) Processing is enabled in both the entering 
and entered spheres* 2) A process is available. The process is 
taken .from the entered sphered hoard* A program which wants to 

be certain it can be entered should get its hoard* 3) A 
capability index in the entered sphere is available for the 

entered process capability » 

An entered process capability is the entered s "link 88 to the 
enterer* Ttmv® is exactly one copy of an entered process 



capability^ it may be granted but not shared* The following ivies 
way to© performed on an entered process capability* 



If A(l4) is zero the operation is a read/write core epera« 
tion* A (13) is O to read the enteree 8 s core* 1 to write. The 
number of words to transfer/4o is in A(6«42)| if this is zero* 
10000 words will be transferred* The address in the enterer Is in 
1(3-17) a nd must be a multiple of 4o words* The eddrss in the 
enteree is in W(3«&7).» The transfer must not cross a core module 
boundary in either sphere* The instruction skiiss if 



successful a 



A i 



TT 



count 



1ET3~W 



aaaaapttaec 



vr 



address in ent erer II 0! 
T~~ — — JS TBT3 — ~T 



w 



Nr-A 



address in enteree 



Other entered process ivies # 
code in A Action 

11 

The Aj I,, and W registers of the entering process are 
read into three consecutive words at the address given In 
1(3-17)* 



31 



The three consecutive words at the address given in 
1(3-17) ®&® written onto the A, I, and w registers of the 

entering process* 



The entering process is restarted and the 
entered process capability Is deleted* The entering 
process will not have its FC advanced or AAL indicator 
cleared^ hence* unless southing has changed*? it will 
execute the s&ise instruction again.* 



Return* The entering process is restarted and the 
entered process capability is deleted* The PC of the 
entering process is advanced to the next instruction* its 
AAL indicator is cleared* and^ if its ESI indicator is 
on* an ESI trap will occur « This makes the enter appear 
to have caapleted* 



Cause illegal instruction* The ivk that the entering 
process executed is treated as a recoverable ille^l 
instruction,, The entered process capability is deleted. 
The process & PC is not advanced^ nor is Ml cleared^ so 
that the process will appear to have not yet executed the 
llle^l instruction** 



131 
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Return and skip* Similar to return (71). except that the 

PC la advanced one nsor© time, omking the" enter appear to 
skip 

Read process number The number of the entering process 
in Its sphere {Is, 2$ 3* 000) is read into A 5 arad the 
sphere to which it belongs (low ia bits of sphere 
capability) is read into lo (Note - Unless processing is 
suppressed f the process number ir^y not be ftx<sdo) This 
instruction skips unless the entering process was deleted 
Ce c go by logout) since it entered* 



STO&RY OP f^TA«INSTRUCTIONS 

mta G Copy A Into W. 

mta 1 Copy I into w. 

mta 2 Copy W into A* 

rata 3 Copy w into I. 

mta 4 cause program trap 10. 

mta 5 Cause program trap 11 (id executes commands K 

mta 6 cause program trap 12. 

mta 7 Cause program trap 13 (dsm, nera&l completion)* 

mta 100 Enter low priority mode,, 

mta ±oh Read absolute drum fields through 77* 

mta 105 Read absolute drum fields 100 through 177* 

mta 200 Read illegal instruction return to A 

mta 201 Set illegal instruction return from A „ 

mta 202 Read illegal memory reference return to A* 

mta 203 Set Illegal memory reference return from A » 

mta 204 Delete capability in A (12-17) « No skip* 

mta 205 Detach » Core number from A (3-5) or A (15-17 h Skip if ok c 

mta 206 Read memory bound to A(3-5)* attachments to A (12-17 h 
No skip* 

mta 207 Set memory bound from A(3-5) ©** A(iJ5-17). Skip if ok* 

mta 300 Create drum field. If A(l)«d» use absolute field in A (5-11) 
If A(o)-&, read only. Skip if ok e 

mta 302 Create sphere. Fault entry address from l Skip if ok 

mta 303 Create queue . Initial population is ~jl|* Skip if ok e 



mfca 306 Creafte r/o device. Skip If ok 

A{0*5) Device A (6*11) contains 

mlcrotape ^ranspor*; no, 

1 buttons console no*, 

2 clock 

3 readier 0-alpha? 1-bin 

4 punch 

5 typewriter console no, 
7 hardware 10 device n-c e 

mta 30? Create entry a Entry address from X, Skip if ok* 

nta 400 Read capability in A(12~17)„ No skip, 

mta 401 Exchange capabilities in A (6-11) and A (12-47) • No skipo 

mta 40£ Turn off PRL. No skip, 

rata 403 Turn on PRL, No skip. 

rata 4o4 Count items in C-llst, return nxamber in A, 

mta 405 Copy capability at 1(6-11) to 1(12-17). Skip if ©k G 

mta 406 Read process hoard to A, No skip* 

mta 407 Set process hoard from A Skip if ok & 

mta 500 Assign and deassign external equipment a 
A (0-5) Operation 

Assign external levels. For all l g i(i( 7, 
external level i is assigned if A{i+l0*js4, & *' 
Skip if ok e 

1 Deassign external levels as above , No skip* 

2 Assign external register , shared <, Skip if ok a 

3 Assign external register 9 private, Skip If ok 

4 Deassign external register a No skip* 

mta 50i Disown capability in i(6-ll).. Return index in A, Skip if ok, 

mta 502 Claim capability at index in x(6-U). Index in self 
is in 1(12-47). Skip if ok 



